home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / ppp107.arc / PPP107.DOC < prev    next >
Text File  |  1980-01-01  |  20KB  |  791 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                     Programmable Printer PopUp Users Guide
  23.  
  24.  
  25.          (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved
  26.  
  27.  
  28.                                  Revision 1.07
  29.  
  30.  
  31.                                     2/05/88
  32.  
  33.  
  34.  
  35.  
  36.  
  37. Programmable Printer PopUp Users Guide                            Version 1.07
  38.  
  39.  
  40.  
  41.  
  42.                  Welcome to PPP - Programmable Printer Pop-Up
  43.  
  44.  
  45.      This program is being distributed as user-supported software.
  46.  
  47.      A limited license is granted to all users of this program, to make
  48.      copies of this program and distribute them to other users, with the
  49.      following conditions :
  50.  
  51.      1. The program is not to be distributed to others in modified form.
  52.      2. No fee is to be charged (or any other consideration received) for
  53.         copying or distributing the program without an express written
  54.         agreement with :
  55.                                 Mark Allen Neil
  56.                                 5627 Silver Leaf Road
  57.                                 San Jose, CA  95138
  58.  
  59.      You are encouraged to copy and share this program with other users.
  60.  
  61.  
  62.      If you find this program useful, please consider sending a contribution
  63.      of $20.00 to the above address to support future enhancements.  Thanks.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                2
  97.  
  98.  
  99.  
  100. Programmable Printer PopUp Users Guide                            Version 1.07
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                 Table Of Contents
  107.  
  108.  
  109.  
  110.           1.0  Introduction
  111.  
  112.           2.0  Features
  113.  
  114.             2.1  Important files
  115.             2.2  The PPP Main Menu
  116.             2.3  The Help Menu
  117.             2.3.1  The HotKey Menu
  118.             2.3.2  The Printer Selection Menu
  119.  
  120.           3.0  Command Line Switches
  121.  
  122.           4.0  Printer Definition Files
  123.  
  124.           5.0  Acknowledgments
  125.  
  126.           6.0  Revision History
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                3
  160.  
  161.  
  162.  
  163. Programmable Printer PopUp Users Guide                            Version 1.07
  164.  
  165.  
  166.  
  167.  1.0  Introduction
  168.  
  169.      Programmable printer popup (PPP) is a utility which allows you to send
  170.      configuration codes to your printer.  PPP can be loaded as a resident
  171.      utility (40 K), or it can be executed from a run time prompt with command
  172.      line parameters.  This document will explain in detail what PPP does, and
  173.      how to use it to your advantage.  First, however, I would like to give you
  174.      some background on why I wrote this program.
  175.  
  176.      I recently purchased a dot-matrix printer, the Toshiba P321 to be exact.
  177.      I bought this printer because it has beautiful letter quality print and a
  178.      very fast, very legible draft mode.  Unfortunately, many software
  179.      packages fail to support this printer, and I did not purchase an
  180.      emulation option.  I immediately began searching through the bulletin
  181.      boards to which I belong for a resident printer control program for the
  182.      P321.  I found a few programs which would configure the printer, but none
  183.      which were resident, and to be honest, none which had a sensible screen
  184.      layout (well, in my opinion).
  185.  
  186.      It occurred to me that others might also have printers which weren't
  187.      commonly supported, and might like a utility to allow them to configure
  188.      their printers.
  189.  
  190.      I started off by writing a simple program in TURBO PASCAL to send
  191.      configuration codes to the printer.  Then I made the whole mess resident
  192.      using some PASCAL source routines downloaded from a local BBS (see
  193.      acknowledgements).  Finally I sped the screen I/O up with some different
  194.      source routines, also downloaded (again, see acknowledgements).
  195.  
  196.      One last note : I will be using trade names in this document (e.g. EPSON)
  197.      without designating the owner, but I will clearly designate trade names
  198.      in capital letter.  I hope my use of the trade names doesn't step on
  199.      anyone's toes.
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                4
  223.  
  224.  
  225.  
  226. Programmable Printer PopUp Users Guide                            Version 1.07
  227.  
  228.  
  229.  
  230.  2.0  Features
  231.  
  232.      PPP was designed to be as easy to use as possible.  There are now two or
  233.      three printer popup programs on the market which have more features, but
  234.      there are advantages to a program with fewer features :
  235.  
  236.       - Easier to learn
  237.       - Easier to use
  238.       - 80 % of the "nifty" features are useless day to day
  239.       - PPP costs less
  240.  
  241.  2.1  Important files
  242.  
  243.      There are 2 basic file types which make up the PPP package.  The first is
  244.      the PPP executable file, called PPP107.COM.  The other type of files are
  245.      called "printer definition files".  Each one of these files has the
  246.      extension ".PPP", e.g. P321.PPP.  The printer definition files define the
  247.      control codes which PPP will send to the printer.  You may have several
  248.      printer control files, and you can switch between them at will.
  249.  
  250.  
  251.  2.2  The PPP Main Menu
  252.  
  253.      When PPP is invoked, either from a command line or by pressing the
  254.      "hotkey", the user is presented with a menu of choices.  This menu consists
  255.      of a list of "options" from which the user can select.  Any combination of
  256.      options can be selected.  An option is selected by moving the ">" character
  257.      up or down to the desired option and pressing the space bar.  Options can
  258.      be toggled off and on by pressing the space bar repeatedly.  An option is
  259.      "selected" when it appears in reverse video.
  260.  
  261.      An "option" is something you would like to tell the printer to do.  For
  262.      example, turning on bold print, enabling compressed mode, or even sending
  263.      the string "Dear Sir," to the printer.  The definition of each option is
  264.      completely under the users control, because the user can customize his
  265.      option menu (Section 4).
  266.  
  267.      When finished selecting options, the user can either hit <RETURN> to send
  268.      the codes to the printer, or <ESC> to exit PPP with no action.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                5
  286.  
  287.  
  288.  
  289. Programmable Printer PopUp Users Guide                            Version 1.07
  290.  
  291.  
  292.      Below is an example of a PPP main menu designed for use with the Toshiba
  293.      P321 printer :
  294.  
  295.                         +============================+
  296.      Title ------->     |     P321 Printer Control   |
  297.                         +----------------------------+
  298.                         |                            |
  299.      Options ----->     | > Eject Page               |
  300.      (up to 16)         |   High Speed               |
  301.                         |   Quality Elite            |
  302.                         |   Quality Courier          |
  303.                         |   10.0 cpi                 |
  304.                         |   12.0 cpi                 |
  305.                         |   16.7 cpi                 |
  306.                         |   Italics On               |
  307.                         |   Italics Off              |
  308.                         |   Bold On                  |
  309.                         |   Bold Off                 |
  310.                         |   "DEAR SIR,"              |
  311.      F1 key brings up   |                            |
  312.      Help Menu ---->    +========[ F1 - HELP ]=======+
  313.  
  314.  
  315.  2.3  The Help Menu
  316.  
  317.      If you have trouble remembering what to do, pressing the F1 key will bring
  318.      up a help menu screen.
  319.  
  320.      This is the PPP Help screen :
  321.  
  322.  
  323.                  +==========================================+
  324.                  |             PPP Help Screen              |
  325.                  +------------------------------------------+
  326.                  | <UP ARROW>     Select previous option    |
  327.                  | <DOWN ARROW>   Select next option        |
  328.                  | <SPACE BAR>    Toggle highlighting       |
  329.                  | <ESC>          Exit without action       |
  330.                  | <RETURN>       Send highlighted commands |
  331.                  |                to printer                |
  332.                  +------------------------------------------+
  333.                  | F1             Change Hotkey             |
  334.                  | F2             Change Printer File       |
  335.                  +========[ Hit any key to exit help ]======+
  336.  
  337.      This screen gives a short description of the keys used in the PPP main
  338.      menu.  There are 2 functions which can be accessed from this menu, changing
  339.      the "hotkey" (F1 key) and changing the current printer file (F2 key).
  340.      Hitting any other key will return you to the main menu.
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                6
  349.  
  350.  
  351.  
  352. Programmable Printer PopUp Users Guide                            Version 1.07
  353.  
  354.  
  355.  2.3.1  The HotKey Menu
  356.  
  357.      The HotKey menu appears if the user presses F1 from the Help menu.  The
  358.      "hotkey" is the key, or combination of keys which causes PPP in a resident
  359.      mode to appear on the screen.  The hotkeys which can be recognized by PPP
  360.      are the function keys F3 through F10, <ALT> F1 through <ALT> F10, and
  361.      <CTRL> F1 through <CTRL> F10.  The hotkey is unimportant when PPP is used
  362.      as a non-resident utility.  The default hotkey used by PPP is <ALT> F8.
  363.  
  364.      When the HotKey menu appears, hit the key combination that you want to
  365.      invoke PPP.  Choose a combination which doesn't conflict with the software
  366.      you use most often.  When you enter the new combination, the keyboard scan
  367.      code for the chosen hotkey will appear on the menu for three seconds, and
  368.      then control will return to the Main menu.If you enter the HotKey menu and
  369.      decide not to change the current hotkey, press the <ESC> key.
  370.  
  371.      To permanently change the hotkey, use the following table to determine the
  372.      scan code for the desired hotkey, and edit this number into the batch file
  373.      which starts PPP107 (Section 3).   PPP will only accept the key
  374.      combinations defined in the table below.
  375.  
  376.      HotKey     Scan Code     HotKey     Scan Code     HotKey     Scan Code
  377.  
  378.      F1         RESERVED      <CTRL> F1         94     <ALT> F1         104
  379.      F2         RESERVED      <CTRL> F2         95     <ALT> F2         105
  380.      F3               61      <CTRL> F3         96     <ALT> F3         106
  381.      F4               62      <CTRL> F4         97     <ALT> F4         107
  382.      F5               63      <CTRL> F5         98     <ALT> F5         108
  383.      F6               64      <CTRL> F6         99     <ALT> F6         109
  384.      F7               65      <CTRL> F7        100     <ALT> F7         110
  385.      F8               66      <CTRL> F8        101     <ALT> F8         111
  386.      F9               67      <CTRL> F9        102     <ALT> F9         112
  387.      F10              68      <CTRL> F10       103     <ALT> F10        113
  388.  
  389.  
  390.      This is the PPP HotKey screen :
  391.  
  392.                                +======================+
  393.                                |  Hit Key Combination |
  394.                                |    for New HotKey    |
  395.                                |                      |
  396.                                | Current Hotkey = 108 |
  397.                                |                      |
  398.                                | New Hotkey     =     |
  399.                                |                      |
  400.                                +==[ <ESC> to Abort ]==+
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                7
  412.  
  413.  
  414.  
  415. Programmable Printer PopUp Users Guide                            Version 1.07
  416.  
  417.  
  418.  2.3.2  The Printer Selection Menu
  419.  
  420.      The Printer Selection menu appears if the user presses F2 from the Help
  421.      menu.  This menu presents a list of all of the printer definition files
  422.      (*.PPP) in the PPP default directory (where PPP was invoked).  The first
  423.      printer listed appears in reverse video.  Use the up and down arrow keys to
  424.      highlight a new printer, and hit <RETURN> to select the new printer.  PPP
  425.      will default upon initialization to the first printer definition file it
  426.      finds in the current directory.
  427.  
  428.      To permanently change the default printer definition file, edit the name of
  429.      the file into the batch file which starts PPP (Section 3).
  430.  
  431.      This is the PPP Printer Selection screen :
  432.  
  433.  
  434.                                  +==========+
  435.                                  | Printers |
  436.                                  +----------+
  437.              Printer definition  | P321     |
  438.              files ------ >      | EPSON    |
  439.                                  | OKIDATA  |
  440.                                  | CITIZEN  |
  441.                                  +==========+
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                8
  475.  
  476.  
  477.  
  478. Programmable Printer PopUp Users Guide                            Version 1.07
  479.  
  480.  
  481.  
  482.  3.0  Command Line Switches
  483.  
  484.      The default configuration of PPP can be modified by entering new defaults
  485.      on the command line, preceded by "switches".  The command line switches
  486.      recognized by PPP are defined as follows :
  487.  
  488.      -R [or \R] nnn   :  This is the Residency switch.  If you want PPP to be a
  489.                          resident application, include this switch.  The default
  490.                          is non-resident.  The "nnn" is the 3 digit hotkey which
  491.                          causes PPP to appear (Section 2.3.1).
  492.  
  493.      -D [or \D] fname :  This is the Default printer configuration file name
  494.                          switch.  This switch tells PPP which printer
  495.                          configuration file to use.  If this switch is omitted,
  496.                          PPP will find the first "PPP" file in the directory
  497.  
  498.      -Q [or \Q]       :  This is the "quick" startup switch, and disables the
  499.                          startup screen.  PPP would be an impractical
  500.                          tool if you had to see my name all the time, but at
  501.                          least the first time you will see who wrote PPP.
  502.  
  503.      Examples :
  504.  
  505.      A>PPP               invoke PPP, non-resident, default to first .PPP file
  506.  
  507.      A>PPP -Q -R 108     invoke PPP, resident with <ALT> F5, no startup screen
  508.  
  509.      A>PPP \Q \D EPSON   invoke PPP, non-resident, default to EPSON.PPP
  510.                          configuration file, no startup screen
  511.  
  512.      A>PPP -Q -R 103 -D P321   invoke PPP, resident with <CNTL> F10, default to
  513.                                P321.PPP configuration file, no startup screen
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                9
  538.  
  539.  
  540.  
  541. Programmable Printer PopUp Users Guide                            Version 1.07
  542.  
  543.  
  544.  4.0  Printer Definition Files
  545.  
  546.      PPP is useless without a definition of control commands to send to the
  547.      printer.  Each printer must have at least one printer definition file
  548.      defining the control commands.  Printer definition files must have the
  549.      extension ".PPP", and they must exist in the directory from which PPP is
  550.      invoked.  Printer definition files are in ASCII format, e.g. they can
  551.      contain no control characters nor tabs.  When editting or creating a new
  552.      printer definition file, edit your work using a "non-document" mode, or
  553.      use a straight ASCII editor, such as PC-Write.
  554.  
  555.      The first line of a printer definition file contains the title.  This title
  556.      appears in the PPP main menu.  The title cannot be more than 40 characters
  557.      in length.
  558.  
  559.      Examples :
  560.  
  561.      P321 Printer Control
  562.  
  563.      Mark's Special Control Menu
  564.  
  565.  
  566.      The next sequence of lines define the printer control options.  Each line
  567.      defines a separate control option.  There can be up to 16 options in each
  568.      file.  Each control option has two parts, the option name, and a sequence
  569.      of decimal byte (< 256) values to send to the printer when that option is
  570.      selected.  The option field occupies the first 40 characters of the line,
  571.      and the byte values follow on the same line anywhere after column 40.
  572.      There can be no additional spaces following the last control byte on a
  573.      line.
  574.  
  575.      Examples :
  576.  
  577.      Option name                           40   Control bytes
  578.  
  579.      Eject Page                               12
  580.  
  581.      10.0 cpi                                             27 42 48 27 69 49 50
  582.  
  583.      "DEAR SIR,"                             68 69 65 82 32 83 73 82 44 13 10
  584.  
  585.  
  586.      The last example above send the string "DEAR SIR," to the printer.
  587.  
  588.      After the last option line, the next line must contain a star "*",
  589.      signifying the end of the printer definition file.
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               10
  601.  
  602.  
  603.  
  604. Programmable Printer PopUp Users Guide                            Version 1.07
  605.  
  606.  
  607.  
  608.      Sample printer definition file for Toshiba P321 printer :
  609.  
  610.  
  611.      P321 Printer Control
  612.      Eject Page                               12
  613.      High Speed                               27 42 48
  614.      Quality Elite                            27 42 49
  615.      Quality Courier                          27 42 50
  616.      10.0 cpi                                 27 42 48 27 69 49 50
  617.      12.0 cpi                                 27 42 48 27 69 49 48
  618.      16.7 cpi                                 27 42 48 27 69 49 48 27 91
  619.      Italics On                               27 18
  620.      Italics Off                              27 20
  621.      Bold On                                  27 75 51
  622.      Bold Off                                 27 77
  623.      "DEAR SIR,"                              68 69 65 82 32 83 73 82 44 13 10
  624.      *
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               11
  664.  
  665.  
  666.  
  667. Programmable Printer PopUp Users Guide                            Version 1.07
  668.  
  669.  
  670.  5.0  Acknowledgments
  671.  
  672.  
  673.      This program would not have been possible were it not for the superior
  674.      programming skill of the following individuals :
  675.  
  676.  
  677.      STAY-RES routines written by Lane H. Ferris of San Francisco, Ca.  These
  678.      public domain routines allowed me to make PPP a resident application.
  679.  
  680.  
  681.      Q SCREEN routines written by Jim LeMay of Ft. Worth, Tx.  These routines
  682.      sped up my screen displays tremendously.
  683.  
  684.  
  685.      My thanks to both of these individuals.
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               12
  727.  
  728.  
  729.  
  730. Programmable Printer PopUp Users Guide                            Version 1.07
  731.  
  732.  
  733.  6.0  Revision History
  734.  
  735.      2/05/88 Rev 1.07
  736.  
  737.              Rewrote PPP to take advantage of newer version of STAY-RES routines
  738.              to eliminate "Interrupt xx already in use" error message.
  739.  
  740.              Option pointer ">" was written in wrong place after returning from
  741.              help menu.  After help, default is now option 1.
  742.  
  743.              Only F3 - F10, <ALT> F1 - <ALT> F10, and <CTRL> F1 - <CTRL> F10 are
  744.              now recognized as valid hotkeys.  This was done to prevent common
  745.              keys like "J" to be defined as hotkeys (which is a real pain).  F1
  746.              and F2 are reserved for menu control.
  747.  
  748.      5/06/87 Rev 1.06
  749.  
  750.              Initial product release (internal rev level 1.06).
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               13
  790.  
  791.